package com.clhbolg.service;

import com.clhbolg.domain.Article;
import com.clhbolg.domain.bo.ArticleBo;
import com.clhbolg.domain.vo.ArticleVo;
import com.clhbolg.model.dto.*;
import com.clhbolg.model.es.ArticleSearchDTO;
import com.clhbolg.model.vo.request.ArticlePasswordVO;
import com.clhbolg.model.vo.request.ArticleTopFeaturedVO;
import com.clhbolg.model.vo.request.ConditionVO;
import com.clhbolg.model.vo.request.LogicalDelVO;
import com.ruoyi.common.core.domain.PageQuery;
import com.ruoyi.common.core.page.TableDataInfo;
import org.springframework.web.multipart.MultipartFile;

import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.Collection;
import java.util.List;

/**
 * 文章Service接口
 *
 * @author cailinhu
 * @date 2023-02-07
 */
public interface IArticleService {

    /**
     * 查询文章
     */
    ArticleVo queryById(Long id);

    /**
     * 查询文章列表
     */
    TableDataInfo<ArticleVo> queryPageList(ArticleBo bo, PageQuery pageQuery);

    /**
     * 查询文章列表
     */
    List<ArticleVo> queryList(ArticleBo bo);

    /**
     * 新增文章
     */
    Boolean insertByBo(ArticleBo bo);

    /**
     * 修改文章
     */
    Boolean updateByBo(ArticleBo bo);

    /**
     * 校验并批量删除文章信息
     */
    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);

    /**
     * 保存和修改文章
     * @param vo
     */
    void saveOrUpdateArticle(ArticleVo vo);

    /**
     * 查询文章列表
     * @param vo
     * @return
     */
    TableDataInfo<ArticleAdminDTO> articleList(ConditionVO vo, PageQuery pageQuery);

    void updateArticleTopAndFeatured(ArticleTopFeaturedVO articleTopFeaturedVO);

    ArticleVo editArticle(Long articleId);

    void delLogicalArticle(LogicalDelVO vo);

    void delArticles(List<Long> ids);

    /**
     * 批量导出
     * @param ids
     * @return
     */
    List<String> articleExport(List<Long> ids);

    /**
     * 测试。本地方式的下载
     * 测试通过
     * @param ids
     * @return
     */
    byte[]  localArticlesExport(List<Long> ids, HttpServletResponse response) throws IOException;

    /**
     * 导入文件
     * @param file
     * @param type
     */
    void articlesImport(MultipartFile file, String type);

    /**
     * 获取置顶和推荐文章
     * @return
     */
    TopAndFeaturedArticlesDTO listTopAndFeaturedArticles();

    /**
     * 用户的文章列表查询
     *
     * @param vo
     * @param pageQuery
     * @return
     */
    TableDataInfo<ArticleCardDTO> userArticleList(ConditionVO vo, PageQuery pageQuery);

    /**
     * 按分类查询文章列表
     *
     * @param categoryId
     * @param pageQuery
     * @return
     */
    TableDataInfo<ArticleCardDTO> listArticlesByCategoryId(Integer categoryId, PageQuery pageQuery);

    /**
     * 根据id获取文章信息
     * @param id
     * @return
     */
    ArticleDTO getArticleById(Long id);

    /**
     * 密码校验
     *
     * @param articlePasswordVO
     */
    void accessArticle(ArticlePasswordVO articlePasswordVO);

    /**、
     * 数据库查询保存文章信息到es
     */
    void saveArticleToEs();

    /**
     * 保存单条文章信息到es
     */
    void saveArticleToEs(Article article);

    /**
     * 修改单条文章信息到es
     * @param article
     */
    void updateArticleToEs(Article article);

    /**
     * 搜索文章
     *
     * @param condition
     * @return
     */
    List<ArticleSearchDTO> listArticleBySearch(ConditionVO condition);

    /**
     * 文章归档
     *
     * @return
     */
    TableDataInfo<ArchiveDTO> listArchives(PageQuery pageQuery);

    /**
     * 通过tagId获取文章卡片列表
     *
     * @param pageQuery
     * @param tagId
     * @return
     */
    TableDataInfo<ArticleCardDTO> getArticleByTag(PageQuery pageQuery, Integer tagId);
}
